home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / usenet / sources / volume91 / news / vnres112 / part03 / help.c < prev    next >
C/C++ Source or Header  |  1991-03-14  |  9KB  |  376 lines
  1. /*
  2. ** vn news reader.
  3. **
  4. ** help.c - print help
  5. **
  6. ** see copyright disclaimer / history in vn.c source file
  7. */
  8. #include <stdio.h>
  9. #include <setjmp.h>
  10. #include "config.h"
  11. #include "tty.h"
  12. #include "tune.h"
  13. #include "node.h"
  14. #include "page.h"
  15. #include "reader.h"
  16. #include "vn.h"
  17.  
  18. extern int L_allow;
  19. extern int C_allow;
  20. extern int Digest;
  21. extern char *Contstr;
  22. extern char Cxptoi[], Cxrtoi[];
  23.  
  24. extern int (*Hookfunc)();
  25. extern char *(*Hookhelp)();
  26.  
  27. static h_print ();
  28.  
  29. /*
  30.     Help message table.  Character for command, plus its help
  31.     message.  Table order is order of presentation to user.
  32. */
  33. static struct HELPTAB
  34. {
  35.     char cmd, *msg;
  36.     int dig;
  37.     char *amsg;
  38. } 
  39. Helptab [] =
  40. {
  41.     { QUIT, "quit", 1, NULL},
  42.     { UP, "(or up arrow) move up [number of lines]", 1, NULL},
  43.     { DOWN, "(or down arrow) move down [number of lines]", 1, NULL},
  44. #ifdef PAGEARROW
  45.     { BACK, "(or left arrow) previous page [number of pages]", 1, NULL},
  46.     { FORWARD, "(or right arrow) next page [number of pages]", 1, NULL},
  47. #else
  48.     { BACK, "previous page [number of pages]", 1, NULL},
  49.     { FORWARD, "next page [number of pages]", 1, NULL},
  50. #endif
  51.     { GRPBACK, "previous newsgroup [number of newsgroups]", 0, NULL },
  52.     { GRPFORWARD, "next newsgroup [number of newsgroups]", 0, NULL },
  53.     { TOPMOVE, "move to top of page", 1, NULL},
  54.     { BOTMOVE, "move to bottom of page", 1, NULL},
  55.     { ALTBOTTOM, "move to bottom of page (alternate L)", 1, NULL},
  56.     { MIDMOVE, "move to middle of page", 1, NULL},
  57.     { DIGEST, "unpack digest", 1, "exit digest"},
  58.     { READ, "read article [number of articles]", 1, NULL},
  59.     { ALTREAD, "read article (alternate 'r')", 1, NULL},
  60.     { READALL, "read all articles on page", 1, NULL},
  61.     { READSTRING, "specify articles to read", 1, NULL},
  62.     { SAVE, "save or pipe article [number of articles]", 1, NULL},
  63.     { SAVEALL, "save or pipe all articles on page", 1, NULL},
  64.     { SAVESTRING, "specify articles to save", 1, NULL},
  65.     { ALTSAVE, "specify articles to save (alternate ctl-s)", 1, NULL},
  66.     { PRINT, "print article [number of articles]", 1, NULL},
  67.     { PRINTALL, "print all article on page", 1, NULL},
  68.     { PRINTSTRING, "specify articles to print", 1, NULL},
  69.     { UPDATE, "update .newsrc status to cursor", 0, NULL},
  70.     { UPALL, "update .newsrc status for whole newsgroup", 0, NULL},
  71.     { UPSEEN, "update .newsrc status for all pages displayed", 0, NULL},
  72.     { ORGGRP, "recover original .newsrc status for newsgroup", 0, NULL},
  73.     { ORGSTAT, "recover all original .newsrc status", 0, NULL},
  74.     { SSTAT, "display count of groups and pages - shown and total", 0, NULL},
  75.     { GRPLIST, "list newsgroups with new article, updated counts", 0, NULL},
  76.     { NEWGROUP, "specify newsgroup to display and/or resubscribe to", 1, NULL},
  77.     { UNSUBSCRIBE, "unsubscribe from group", 0, NULL},
  78.     { MARK, "mark/unmark article [number of articles]", 1, NULL},
  79.     { ART_MARK, "mark/unmark article [number of articles]", 1, NULL},
  80.     { UNMARK, "erase marks on articles", 1, NULL},
  81.     { MARKSTRING, "specify articles to mark/unmark", 1, NULL},
  82.     { HEADTOG, "toggle flag for display of headers when reading", 1, NULL},
  83.     { SETROT, "toggle rotation for reading", 1, NULL},
  84.     { REDRAW, "redraw screen", 1, NULL},
  85. #ifdef amiga
  86.     { UNESC, "escape to AMIGADOS to execute a command", 1, NULL},
  87. #else
  88.     { UNESC, "escape to UNIX to execute a command", 1, NULL},
  89. #endif
  90.     { PRTVERSION, "show vn version", 1, NULL},
  91.     { HELP, "show this help menu", 1, NULL}
  92. };
  93.  
  94. #define HTSIZE (sizeof(Helptab)/sizeof(struct HELPTAB))
  95.  
  96.  
  97. #ifdef amiga
  98. extern char pr_buf[];
  99. extern ttputc ();
  100. #endif
  101.  
  102. #define HHLINES 5    /* lines (CRs + 1) contained in HELP_HEAD */
  103. /*
  104.     help from main screen
  105. */
  106. help ()
  107. {
  108.     int i,lcount,lim;
  109.     char *hs;
  110.     char c;
  111.  
  112.     term_set (ERASE);
  113.     lim = L_allow + RECBIAS - 2;
  114. #ifdef amiga
  115.     sprintf(pr_buf,"%s\n","[...] = effect of optional number preceding command\n");
  116.     tputs(pr_buf,1,ttputc);
  117.     sprintf(pr_buf,"%s\n","pipes are specified by filenames beginning with |\n");
  118.     tputs(pr_buf,1,ttputc);
  119.     sprintf(pr_buf,"%s\n","articles specified as a list of numbers, title search string, or\n");
  120.     tputs(pr_buf,1,ttputc);
  121.     sprintf(pr_buf,"%s\n","    * to specify marked articles.  ! may be used to negate any\n");
  122.     tputs(pr_buf,1,ttputc);
  123. #else
  124.     printf("%s\n","[...] = effect of optional number preceding command\n");
  125.     printf("%s\n","pipes are specified by filenames beginning with |\n");
  126.     printf("%s\n","articles specified as a list of numbers, title search string, or\n");
  127.     printf("%s\n","    * to specify marked articles.  ! may be used to negate any\n");
  128. #endif
  129.     lcount = HHLINES;
  130.     for (i=0; i < HTSIZE; ++i)
  131.     {
  132.         if (Digest && !(Helptab[i].dig))
  133.             continue;
  134.         if (Hookfunc != NULL && (*Hookfunc)(Helptab[i].cmd,0,0) >= 0)
  135.             continue;
  136.         ++lcount;
  137.         if (Digest && Helptab[i].amsg != NULL)
  138.             h_print (Cxptoi[Helptab[i].cmd],Helptab[i].amsg);
  139.         else
  140.             h_print (Cxptoi[Helptab[i].cmd],Helptab[i].msg);
  141.         if (lcount >= lim)
  142.         {
  143. #ifdef amiga
  144.             sprintf (pr_buf,"\n%s",Contstr);
  145.             tputs(pr_buf,1,ttputc);
  146. #else
  147.             printf ("\n%s",Contstr);
  148. #endif
  149.             getnoctl ();
  150.             term_set (MOVE,0,lim+1);
  151.             term_set (ZAP,0,strlen(Contstr));
  152.             term_set (MOVE,0,lim-1);
  153.             putchar ('\n');
  154.             lcount = 0;
  155.         }
  156.     }
  157.     if (Hookhelp != NULL)
  158.     {
  159.         for (hs=(*Hookhelp)(0,1,&c);
  160.                 hs != NULL; hs = (*Hookhelp)(0,0,&c))
  161.         {
  162.             ++lcount;
  163.             h_print (Cxptoi[c],hs);
  164.             if (lcount >= lim)
  165.             {
  166. #ifdef amiga
  167.                 sprintf (pr_buf,"\n%s",Contstr);
  168.                 tputs(pr_buf,1,ttputc);
  169. #else
  170.                 printf ("\n%s",Contstr);
  171. #endif
  172.                 getnoctl ();
  173.                 term_set (MOVE,0,lim+1);
  174.                 term_set (ZAP,0,strlen(Contstr));
  175.                 term_set (MOVE,0,lim-1);
  176.                 putchar ('\n');
  177.                 lcount = 0;
  178.             }
  179.         }
  180.     }
  181.     if (lcount > 0)
  182.     {
  183. #ifdef amiga
  184.         sprintf (pr_buf,"\n%s",Contstr);
  185.         tputs(pr_buf,1,ttputc);
  186. #else
  187.         printf ("\n%s",Contstr);
  188. #endif
  189.         getnoctl ();
  190.     }
  191. }
  192.  
  193. /*
  194.     help from reader
  195. */
  196. help_rd()
  197. {
  198.     char *hs;
  199.     char c;
  200.  
  201. #ifdef amiga
  202.     sprintf(pr_buf,"\n");    /* "confused" tab expansion on first line */
  203.     tputs(pr_buf,1,ttputc);
  204. #else
  205.     printf("\n");    /* "confused" tab expansion on first line */
  206. #endif
  207.  
  208.     hr_print (Cxrtoi[PG_NEXT],HPG_NEXT);
  209.     hr_print (Cxrtoi[PG_QUIT],HPG_QUIT);
  210.     hr_print (Cxrtoi[PG_FLIP],HPG_FLIP);
  211.     hr_print (Cxrtoi[PG_REWIND],HPG_REWIND);
  212.     hr_print (Cxrtoi[PG_WIND],HPG_WIND);
  213.     hr_print (Cxrtoi[PG_SEARCH],HPG_SEARCH);
  214.     hr_print (Cxrtoi[PG_STEP],HPG_STEP);
  215.     hr_print (Cxrtoi[PG_REPLY],HPG_REPLY);
  216.     hr_print (Cxrtoi[PG_FOLLOW],HPG_FOLLOW);
  217.     hr_print (Cxrtoi[SAVE],HPG_SAVE);
  218.     hr_print (Cxrtoi[PRINT],HPG_PRINT);
  219.     hr_print (Cxrtoi[SETROT],HPG_ROT);
  220.     hr_print (Cxrtoi[HEADTOG],HPG_HEAD);
  221.     hr_print (Cxrtoi[PG_HELP],HPG_HELP);
  222.     if (Hookhelp != NULL)
  223.     {
  224.         for (hs=(*Hookhelp)(1,1,&c);
  225.                 hs != NULL; hs = (*Hookhelp)(1,0,&c))
  226.             h_print (Cxrtoi[c],hs);
  227.     }
  228. #ifdef amiga
  229.     sprintf (pr_buf,"%s\n",HPG_DEF);
  230.     tputs(pr_buf,1,ttputc);
  231. #else
  232.     printf ("%s\n",HPG_DEF);
  233. #endif
  234. }
  235.  
  236. hr_print(c,msg)
  237. char c;
  238. char *msg;
  239. {
  240.     if (Hookfunc == NULL || (*Hookfunc)(c,1,0) < 0)
  241.         h_print(c,msg);
  242. }
  243.  
  244. srch_help(c,dig)
  245. char c;
  246. int *dig;
  247. {
  248.     int i;
  249.  
  250.     for (i=0; i < HTSIZE; ++i)
  251.         if (Helptab[i].cmd == c)
  252.             break;
  253.     if (i < HTSIZE)
  254.     {
  255.         *dig = Helptab[i].dig;
  256.         return (0);
  257.     }
  258.     return(-1);
  259. }
  260.  
  261. /*
  262.     h_print prints a character and a legend for a help menu.
  263. */
  264. static
  265. h_print(c,s)
  266. char c,*s;
  267. {
  268.     if (strlen(s) > (C_allow - 14))
  269.         s [C_allow - 14] = '\0';
  270.     if (c > ' ' && c != '\177') {
  271. #ifdef amiga
  272.         sprintf (pr_buf,"     %c - %s\n",c,s);
  273.         tputs(pr_buf,1,ttputc);
  274. #else
  275.         printf ("     %c - %s\n",c,s);
  276. #endif
  277.     } else
  278.     {
  279.         switch (c)
  280.         {
  281.         case '\177':
  282. #ifdef amiga
  283.             sprintf (pr_buf,"  <delete> - %s\n",s);  
  284.             tputs(pr_buf,1,ttputc);
  285. #else
  286.             printf ("  <delete> - %s\n",s);  
  287. #endif
  288.             break;
  289.         case '\040':
  290. #ifdef amiga
  291.             sprintf (pr_buf,"   <space> - %s\n",s);  
  292.             tputs(pr_buf,1,ttputc);
  293. #else
  294.             printf ("   <space> - %s\n",s);  
  295. #endif
  296.             break;
  297.         case '\033':
  298. #ifdef amiga
  299.             sprintf (pr_buf,"  <escape> - %s\n",s);  
  300.             tputs(pr_buf,1,ttputc);
  301. #else
  302.             printf ("  <escape> - %s\n",s);  
  303. #endif
  304.             break;
  305.         case '\n':
  306. #ifdef amiga
  307.             sprintf (pr_buf,"  <return> - %s\n",s);  
  308.             tputs(pr_buf,1,ttputc);
  309. #else
  310.             printf ("  <return> - %s\n",s);  
  311. #endif
  312.             break;
  313.         case '\t':
  314. #ifdef amiga
  315.             sprintf (pr_buf,"     <tab> - %s\n",s);  
  316.             tputs(pr_buf,1,ttputc);
  317. #else
  318.             printf ("     <tab> - %s\n",s);  
  319. #endif
  320.             break;
  321.         case '\b':
  322. #ifdef amiga
  323.             sprintf (pr_buf," <back sp> - %s\n",s);  
  324.             tputs(pr_buf,1,ttputc);
  325. #else
  326.             printf (" <back sp> - %s\n",s);  
  327. #endif
  328.             break;
  329.         case '\f':
  330. #ifdef amiga
  331.             sprintf (pr_buf,"<formfeed> - %s\n",s);  
  332.             tputs(pr_buf,1,ttputc);
  333. #else
  334.             printf ("<formfeed> - %s\n",s);  
  335. #endif
  336.             break;
  337.         case '\07':
  338. #ifdef amiga
  339.             sprintf (pr_buf,"    <bell> - %s\n",s);  
  340.             tputs(pr_buf,1,ttputc);
  341. #else
  342.             printf ("    <bell> - %s\n",s);  
  343. #endif
  344.             break;
  345.         case '\0':
  346. #ifdef amiga
  347.             sprintf (pr_buf,"    <null> - %s\n",s);  
  348.             tputs(pr_buf,1,ttputc);
  349. #else
  350.             printf ("    <null> - %s\n",s);  
  351. #endif
  352.             break;
  353.         default:
  354.             if (c < '\033')
  355.             {
  356.                 c += 'a' - 1;
  357. #ifdef amiga
  358.                 sprintf(pr_buf," control-%c - %s\n",c,s);
  359.                 tputs(pr_buf,1,ttputc);
  360. #else
  361.                 printf(" control-%c - %s\n",c,s);
  362. #endif
  363.             }
  364.             else {
  365. #ifdef amiga
  366.                 printf(pr_buf,"       %c0%o - %s\n",'\\',(int) c,s);
  367.                 tputs(pr_buf,1,ttputc);
  368. #else
  369.                 printf("       %c0%o - %s\n",'\\',(int) c,s);
  370. #endif
  371.             }
  372.             break;
  373.         }
  374.     }
  375. }
  376.